home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 701-725 / 721 / dpu / dpu.doc < prev    next >
Text File  |  1995-03-18  |  14KB  |  402 lines
  1.  
  2.      *****************************************************************
  3.      *                                                               *
  4.      *                    Disk Peek and Update (DPU)                 *
  5.      *                                                               *
  6.      *                          Version 1.2                          *
  7.      *                                                               *
  8.      *                          23 June 1992                         *
  9.      *                                                               *
  10.      *                 Copyright © 1992 Frans Zuydwijk               *
  11.      *                                                               *
  12.      *****************************************************************
  13.  
  14.  
  15.      Table of contents
  16.  
  17.      1. Introduction
  18.      2. Distribution
  19.      3. Be careful with writing
  20.      4. Controlling DPU
  21.      5. Functions in the main menu
  22.         5.1. Select Device
  23.         5.2. Show Device Info
  24.         5.3. Show BitMap
  25.         5.4. Check Disk
  26.         5.5. Zap File
  27.         5.6. Zap Disk
  28.         5.7. Zap FileSystem
  29.         5.8. Zap Rigid Disk Blocks
  30.      6. Edit Sector
  31.      7. Developing environment
  32.      8. Bug reports
  33.      9. History
  34.  
  35.  
  36.  
  37.      1. Introduction
  38.  
  39.      DPU is a program, which enables you to get information about the
  40.      physical contents of your disks and diskfiles. Furthermore you can
  41.      change these contents.
  42.  
  43.  
  44.      2. Distribution
  45.  
  46.      DPU is NOT Public Domain, but freeware : it may be distributed and
  47.      used freely.
  48.  
  49.      DPU may not be sold, but inclusion in a PD-library is permitted as
  50.      long as only a SMALL fee is charged to cover the costs of copying and
  51.      distribution. The Fred Fish Library is the perfect example.
  52.  
  53.      Program and documentation must be distributed together.
  54.      It concerns the files DPU, DPU.info and DPU.doc.
  55.  
  56.  
  57.      3. Be careful with writing.
  58.  
  59.      You cannot change any data on your disk with DPU, apart from using the
  60.      Write gadget in the 'Edit' environment. To be on the safe side, you
  61.      have to press a Shift key at the same time too.
  62.  
  63.      If you want to change anything, be sure that you know what you do,
  64.      it's easy to corrupt an executable file or a whole disk.
  65.  
  66.      I do not take any responsibility for what you do with this program.
  67.  
  68.  
  69.      4. Controlling DPU
  70.  
  71.      DPU uses a 640 x 256 non-interlaced screen. In case this is not
  72.      possible, probably because of a NTSC system instead of a PAL, an
  73.      interlaced screen is used.
  74.  
  75.      You control DPU by mouse and/or function keys.
  76.  
  77.      The button gadgets can be operated by clicking the mouse on them.
  78.      Operation can also be done by pressing the (function) key indicated on
  79.      the gadget.
  80.  
  81.      In case of writing you must press a shift key together with pressing
  82.      the function key or clicking the gadget.
  83.  
  84.      Requesters are used to ask or supply information.
  85.      Instead of clicking on an OK or Continue gadget in a requester, you
  86.      may also press the Return key. Cancel gadgets can only be operated by
  87.      clicking on them.
  88.  
  89.  
  90.      5. Functions in the main menu
  91.  
  92.      In the main menu you see the possible functions.
  93.  
  94.      Choose a function by clicking on the gadget or pressing the
  95.      corresponding function key.
  96.  
  97.      If DPU cannot find Rigid Disk Blocks for the currently selected
  98.      device, the Zap RDB gadget will be ghosted.
  99.  
  100.      You must select a device first, before you can perform the other
  101.      functions. The only exception is the Zap File function.
  102.  
  103.  
  104.      5.1. Select Device
  105.  
  106.      This function shows you the disk devices, which DPU has found. If
  107.      there is a volume present, it's name is shown.
  108.  
  109.      Select the device you want to operate upon. You cannot select a device
  110.      without a volume present.
  111.  
  112.  
  113.      5.2. Show Device Info
  114.  
  115.      This function shows you some information about the selected device.
  116.  
  117.  
  118.      5.3. Show BitMap
  119.  
  120.      This function reads the bitmap sectors of the selected device and
  121.      shows the usage of the disk in a graphical way.
  122.  
  123.      For a floppy disk each square represents a sector, but for harddisk
  124.      partitions each square represents one or more sectors, as indicated on
  125.      the screen.
  126.  
  127.  
  128.      5.4. Check Disk
  129.  
  130.      This function reads all sectors of the selected device track by track.
  131.      Errors encountered are reported.
  132.  
  133.      In a requester the current track is reported. You may abort this
  134.      function by clicking the Cancel gadget in this requester.
  135.  
  136.  
  137.      5.5. Zap File
  138.  
  139.      You are requested to enter the name of the file to be edited. This is
  140.      a simple requester and you must supply the filename including the full
  141.      path, if the file is not in the current directory.
  142.  
  143.      If the operating system is Release 2.04 or higher, the ASL requester
  144.      will be used instead. Else, if DPU finds ARP V39 or higher, the ARP
  145.      requester will be used.
  146.  
  147.      The file is read and shown sector by sector (512 bytes).
  148.      You can walk through the file using mouse or function keys.
  149.  
  150.      F1: Edit      --> Edit sector, see the 'Edit sector' section.
  151.  
  152.      F2: Find      --> Search for an ASCII or HEX string.
  153.                        A requester appears, in which you must enter the
  154.                        string. To indicate ASCII or HEX, click the ASC/HEX
  155.                        gadget to toggle.
  156.                        Searching starts at the current sector. Progress is
  157.                        reported in a requester. You may click the Cancel
  158.                        gadget to abort searching.
  159.  
  160.      F3: Find Next --> Search for the next instance of the string.
  161.  
  162.      F4: Not used.
  163.  
  164.      F5: Goto      --> Go to a specific sector.
  165.                        You must specify the number of this sector in a
  166.                        requester.
  167.  
  168.      F6: Top       --> Go to the first sector.
  169.  
  170.      F7: Backward  --> Go to the previous sector.
  171.  
  172.      F8: Forward   --> Go to the next sector.
  173.  
  174.      F9: Bottom    --> Go to the last sector.
  175.  
  176.      F10: Menu     --> Go back to the main menu.
  177.  
  178.  
  179.      5.6. Zap Disk
  180.  
  181.      The first sector of the selected device is read and shown.
  182.      You can walk through the disk using mouse or function keys.
  183.  
  184.      F1: Edit      --> Edit sector, see the 'Edit sector' section.
  185.  
  186.      F2: Find      --> Search for an ASCII or HEX string.
  187.                        A requester appears, in which you must enter the
  188.                        string. To indicate ASCII or HEX, click the ASC/HEX
  189.                        gadget to toggle.
  190.                        Searching starts at the current sector. Progress is
  191.                        reported in a requester. You may click the Cancel
  192.                        gadget to abort searching.
  193.  
  194.      F3: Find Next --> Search for the next instance of the string.
  195.  
  196.      F4: Identify  --> Identify current sector.
  197.                        The AmigaDOS file structure is searched for the
  198.                        current sector number and info about the sector is
  199.                        reported, e.g. 'sector is free', or 'sector is block
  200.                        xx in file yy'.
  201.                        Progress is reported in a requester. You may click
  202.                        the Cancel gadget to abort searching.
  203.  
  204.      F5: Goto      --> Go to a specific sector.
  205.                        You must specify the number of this sector in a
  206.                        requester. To indicate ASCII or HEX, click the
  207.                        ASC/HEX gadget to toggle.
  208.  
  209.      F6: Top       --> Go to the first sector.
  210.  
  211.      F7: Backward  --> Go to the previous sector.
  212.  
  213.      F8: Forward   --> Go to the next sector.
  214.  
  215.      F9: Bottom    --> Go to the last sector.
  216.  
  217.      F10: Menu     --> Go back to the main menu.
  218.  
  219.  
  220.      5.7. Zap FileSystem
  221.  
  222.      The root sector of the selected device is read and shown.
  223.  
  224.      You can move through the 4-byte longwords in a sector using mouse or
  225.      cursor keys. In the upper right corner you see the purpose of each
  226.      longword.
  227.  
  228.      In case a longword points to another sector in the filestructure, the
  229.      Jump gadget becomes non-ghosted and you may jump to that sector. In
  230.      this way you can walk through all sectors of the filestructure (root-,
  231.      directory-, fileheader-, hardlink-, softlink-, file extension- and
  232.      datablocks).
  233.  
  234.      You can walk through the filestructure using mouse or function keys.
  235.      The functions of the gadgets/function keys vary, depending on the type
  236.      of the current block.
  237.  
  238.      F1: Edit      --> Edit sector, see the 'Edit sector' section.
  239.  
  240.      F2: Date      --> Show the date(s) in the current block.
  241.  
  242.      F3: BitMap    --> Show the BitMap of the disk/partition.
  243.                        Root block only.
  244.      F3: Root      --> Go to the root block.
  245.  
  246.      F4: Locate    --> A directory or fileheader block can be located.
  247.                        A requester appears and asks for the name. The
  248.                        AmigaDOS file structure is then searched for a block
  249.                        with this name. If found, go to the block.
  250.  
  251.      F5: Jump      --> Go to the block, indicated by the currently selected
  252.                        longword. If the longword does not contain a valid
  253.                        sector number, the gadget is ghosted.
  254.  
  255.      F6: Parent    --> Go to the parent block of the current block.
  256.      F6: Header    --> Go to the fileheader block of the current block.
  257.  
  258.      F7: HashChain --> Go to the block, indicated by the hashchain
  259.                        longword.
  260.      F7: Backward  --> Go to the previous data block.
  261.  
  262.      F8: Data      --> Go to the first data block of the file.
  263.      F8: Forward   --> Go to the next data block.
  264.      F8: Link      --> Go to the block, indicated by the hardlink
  265.                        longword.
  266.  
  267.      F9: LinkBack  --> Go to the block, indicated by the hardlinkback
  268.                        longword.
  269.      F9: Extens.   --> Go to the block, indicated by the file extension
  270.                        longword.
  271.      F9: Last Bl.  --> Go to the last data block.
  272.  
  273.      F10: Menu     --> Go back to the main menu.
  274.  
  275.  
  276.      5.8. Zap Rigid Disk Blocks
  277.  
  278.      With this function you can see the contents of the Rigid Disk Blocks
  279.      on your harddisk. You can change it too, but again : know what you do!
  280.  
  281.      When you select a harddisk partition with Select Device, DPU checks if
  282.      the first physical cylinder of this harddisk contains RDB information.
  283.      If so, the gadget of this function is made non-ghosted.
  284.  
  285.      DPU reads the RDSK block and shows it to you.
  286.  
  287.      From here you can walk through the blocks using mouse or function
  288.      keys. The functions of the gadgets/function keys vary, depending on
  289.      the type of the current block.
  290.  
  291.      You can move through the 4-byte longwords in a block using mouse or
  292.      cursor keys. The top line describes the purpose of each longword.
  293.  
  294.      F1: Edit      --> Edit sector, see the 'Edit sector' section.
  295.  
  296.      F2: Go RDSK   --> Go to the RDSK block.
  297.      F2: Go BADB   --> Go to the first/next BADB block.
  298.  
  299.      F3: Go PART   --> Go to the first/next PART block.
  300.  
  301.      F4: Go FSHD   --> Go to the first/next FSHD block.
  302.  
  303.      F5: Go LSEG   --> Go to the first/next LSEG block.
  304.  
  305.      F6: Top       --> Go to the first RDB.
  306.  
  307.      F7: Backward  --> Go to the previous RDB.
  308.  
  309.      F8: Forward   --> Go to the next RDB.
  310.  
  311.      F9: Bottom    --> Go to the last RDB.
  312.  
  313.      F10: Menu     --> Go back to the main menu.
  314.  
  315.  
  316.      6. Edit Sector
  317.  
  318.      When you select 'Edit' in one of the above functions, a cursor appears
  319.      and a new set of function gadgets is shown.
  320.  
  321.      You may now type over the information in the current sector. The new
  322.      characters are shown in a different color.
  323.  
  324.      You can move the cursor with mouse or cursor keys.
  325.  
  326.      Nothing will be changed on disk, unless you select the 'SF5: Write'
  327.      gadget or press the F5 function key. In both cases you have to press a
  328.      Shift key at the same time too.
  329.  
  330.      F1: Hex     --> Edit hexadecimal.
  331.  
  332.      F2: Ascii   --> Edit Ascii.
  333.  
  334.      F3: Not used.
  335.  
  336.      F4: Print   --> Print sector.
  337.  
  338.      SF5: Write  --> Write sector. You must press a shift key too.
  339.                      If the sector contains a checksum, this will be
  340.                      computed before writing, so you cannot change a
  341.                      checksum.
  342.  
  343.      F6: Top     --> Move cursor to first byte.
  344.  
  345.      F7: Not used.
  346.  
  347.      F8: Not used.
  348.  
  349.      F9: Bottom  --> Move cursor to last byte.
  350.  
  351.      F10: Return --> Leave edit environment and return to function.
  352.                      If you did not select 'SF5: Write', the current sector
  353.                      will be unchanged.
  354.  
  355.  
  356.      7. Developing environment
  357.  
  358.      Computer : A2000, 1 MB Chip RAM, 2 MB Fast RAM.
  359.      Devices  : - trackdisk.device (floppy disk).
  360.                 - supradirect.device (Supra WordSync Series II harddisk).
  361.                 - janus.device (Amiga partition of harddisk on PC side of
  362.                   XT Bridgeboard).
  363.      OS       : 1.3 / 2.04
  364.      Compiler : SAS/C Version 5.10a
  365.  
  366.  
  367.      8. Bug reports
  368.  
  369.      Bug reports, comments etc. can be sent to:
  370.  
  371.          Frans Zuydwijk
  372.          Konijnenweide 84
  373.          2727GH Zoetermeer
  374.          Nederland
  375.  
  376.  
  377.      9. History
  378.  
  379.         - Version 1.0 : 9 May 1992
  380.                         First release.
  381.  
  382.         - Version 1.1 : 8 June 1992
  383.           New         : The ASL filerequester will be used in case of
  384.                         Release 2.04 or higher.
  385.           Bugfix      : The information in the BitMap Extension blocks was
  386.                         misinterpreted (partitions >= 50 MB).
  387.  
  388.         - Version 1.2 : 23 June 1992
  389.           New         : Requester looks are changed.
  390.                         Shift keys to indicate ASCII or HEX are replaced by
  391.                         a toggle gadget in the requesters.
  392.                         Not used gadgets are ghosted.
  393.                         AmigaDOS requesters are suppressed during Select
  394.                         Device.
  395.           Bugfixes    : If the user set a high keyboard repeat rate with
  396.                         Prefs/Input, DPU could get an Address Error or hang
  397.                         during moving with the cursor keys.
  398.                         Device names of more than 3 characters are no
  399.                         longer chopped.
  400.  
  401.  
  402.